home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-21 / dvps1.zip / PS.DOC < prev    next >
Text File  |  1991-05-24  |  17KB  |  447 lines
  1.  
  2.  
  3.  
  4.                                 PHAST SPOOL
  5.                                 ^^^^^^^^^^^
  6.                       Copyright (c) 1991 by Len Wilson
  7.                            Netmail c/o 1:104/425
  8.  
  9.                              *** SHAREWARE ***
  10.  
  11.                  A print spooler and printer control program
  12.  
  13.  
  14.                                 Requirements
  15.                                 ~~~~~~~~~~~~
  16.                           AT compatible 386 or 486 (some 286's)
  17.                           DESQview Version 2.xx
  18.                           Buffered parallel printer, LPT1-3
  19.  
  20.      BACKGROUND
  21.      ~~~~~~~~~~
  22.         Traditional, DOS-only, print spoolers like PRINT.COM must create
  23.      their own background process.  They do this by becoming a TSR and
  24.      using the timer and/or printer interrupts to synchronize output to
  25.      the printer.  They also have to perform some "unsupported" gymnas-
  26.      tics to read data from the disk.  In their day, they could be con-
  27.      sidered examples of pretty slick programming - multitasking on PC's.
  28.  
  29.         The introduction of 386's and multitaskers, like DESQview, has
  30.      made all such software obsolete!
  31.  
  32.      PHAST SPOOL
  33.      ~~~~~~~~~~~
  34.         PS is specifically designed to run in a DV window.  It doesn't
  35.      use any hardware interrupts and uses less than 11k of your memory.
  36.      PS requires approx. 50% less processing time than PRINT.COM!  It
  37.      achieves some of its efficiency by writing directly to the printer
  38.      ports*.  PS can run in a very small timeslice, if necessary, with
  39.      DV's foreground/background ticks ratio set to 15 or 20 to 1.
  40.  
  41.         In addition to being a very efficient spooler, PS is a power-
  42.      ful printer control program with user-defined "EZ" commands.  Con-
  43.      sider the following PS entry.
  44.  
  45.                     MYFILE.TXT #5 EL DR CO
  46.  
  47.         This would cause 5 copies (#5) of MYFILE.TXT to be printed in
  48.      elite/draft/condensed mode.  This example assumes the use of one
  49.      of the included Command Definition Files (CDF's).  CDF's are used
  50.      to customize the program for ANY printer.  They are created using
  51.      any text editor and information from your printer manual.  More on
  52.      this later.
  53.  
  54.  
  55.  
  56.      * Because it writes directly to printer ports, its output can't be
  57.        redirected to a serial printer or a file.
  58.  
  59.  
  60.  
  61.                                SPECIAL KEYS
  62.                                ~~~~~~~~~~~~
  63.  
  64.       Spacebar:  Tap the spacebar to get the cursor.
  65.  
  66.       Escape  :  The escape key is always available to quit input mode
  67.                  or to exit the program.
  68.  
  69.       UP/DN   :  Used to position the triangular pointer.
  70.  
  71.  
  72.  
  73.  
  74.                                   THE MENU
  75.                                   ~~~~~~~~
  76.  
  77.             Menu items may be selected by pressing the associated function
  78.       key or clicking on the item with the mouse.
  79.  
  80.  
  81.      LPTX (F1)
  82.      ~~~~~~~~~
  83.             If the printer is turned on, PS will find it when you open the
  84.       window and LPTn will be displayed ( n = printer number ).  If the
  85.       printer is off, turn it on and press F1.  If you have more than 1
  86.       printer turned on, press F1 to switch printers.  See the note on
  87.       multiple printers.                               ~~~~~~~~~~~~~~~
  88.       ~~~~~~~~~~~~~~~~~
  89.  
  90.      STOP (F2)
  91.      ~~~~~~~~~
  92.             Stop is intended for use in the following disastrous situations.
  93.  
  94.                   1) Paper jam or misalignment.
  95.  
  96.                   2) You change your mind or see that a file you
  97.                      didn't intend to print is being printed
  98.                      (because of wildcards or printer batch file).
  99.  
  100.             Pressing F2 causes a hard reset to the printer and PS is put
  101.        in "hold" mode.  To restart after pressing F2, position the pointer
  102.        to the filename you wish to start with and press F3 (Start).
  103.  
  104.  
  105.      START (F3)
  106.      ~~~~~~~~~~
  107.             After entering one or more filenames, press F3 to start printing.
  108.        If printing has been stopped using F2 or is in "hold" mode (#h com-
  109.        mand), you must position the pointer to the next file to be printed
  110.        before starting.  (cont.)
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.      (F3 cont)
  118.             If using F3 to restart after stopping (F2), you will be promp-
  119.        ted, "Start with page:" and be allowed to indicate which page print-
  120.        ing is to start with (1 is default).  Press RET or click on F3 to
  121.        accept the default.  The program counts formfeeds to determine page
  122.        number.  This feature won't work if the document has no formfeed
  123.        codes.  If no FF's are found, printing will start with page 1.
  124.  
  125.  
  126.      DEL (F4)
  127.      ~~~~~~~~
  128.             To delete an entry, position the pointer to it and press F4.
  129.        Deleting the filename being printed or entries preceeding it is
  130.        not permitted.
  131.             The mouse can be used for this - click on the entry then click
  132.        on the menu.
  133.  
  134.  
  135.      CHDIR (F5)
  136.      ~~~~~~~~~~
  137.             Pressing F5 will allow you to change the default directory (and
  138.        drive).
  139.  
  140.  
  141.      BKGND (F6)
  142.      ~~~~~~~~~~
  143.             Pressing F6 will put Phast Spool into background.  Use DV's
  144.        "Switch Windows" to get it back.
  145.  
  146.  
  147.                        ENTERING FILENAMES AND COMMANDS
  148.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  149.            When you open the Phast Spool window,  you will see a bright tri-
  150.      angular pointer at the upper left corner of the display just under the
  151.      menu.  Tap the spacebar to get the cursor and enter a filename.
  152.  
  153.            Follow the normal DOS rules for specifying files.  The default
  154.      directory is shown at the bottom of the window. You can set the default
  155.      directory for the program by entering it on page 1 of DV's "Change a
  156.      Program" (Directory...:).  You may change this in the program by press-
  157.      ing F5 (Chdir).  Or, you can enter the full path and filename.
  158.  
  159.            Wildcards are OK, but only for files in the current directory.
  160.  
  161.            EZ commands can be entered following the filename or on a line
  162.      by themselves.  If a line has commands only, it should begin with the
  163.      "/" character.
  164.  
  165.                Examples:   /re
  166.                            d:\letters\report.txt pi lq #4
  167.                            PROGRAM.LST EL DR FF
  168.                            *.LOG
  169.                            /RE FF
  170.  
  171.  
  172.  
  173.                            COMMAND DEFINITION FILES
  174.                            ~~~~~~~~~~~~~~~~~~~~~~~~
  175.         CDF's can be created using any text editor.  Just use the included
  176.    files - IBMPRO.CDF, IBMGRPH.CDF and LQ1000.CDF - as examples.  There can
  177.    be up to 40 commands in a file.  Some comments are advisible, however, the
  178.    size of a CDF is limited to 1536 bytes and verbose comments can easily
  179.    cause this limit to be exceeded. Control strings may be entered in hex if
  180.    you wish.  Hex entries must start with "\".  The various control strings
  181.    that can be used with a particular printer can usually be found in its
  182.    manual.
  183.  
  184.  
  185.                                Examples:
  186.  
  187.                 Your EZ command        The control string
  188.                 _______________        __________________
  189.                               |        |
  190.                               |__ _____|
  191.                                CO 27 15    ; Semicolons preceed comments.
  192.                                            ; Use single spaces as separators.
  193.                                   or
  194.  
  195.                                CO \1B 0F   ; Example of hex.
  196.  
  197.          EZ commands must be the first 2 characters (letters or numbers) on
  198.      a line.  The maximum length of a control string is 12 characters.  Phast
  199.      Spool doesn't distinguish between upper and lower case.
  200.  
  201.      Contents of an actual CDF
  202.      ~~~~~~~~~~~~~~~~~~~~~~~~~
  203.      ; This CDF is for Epson LQ1000 or equiv.
  204.      LQ 27 120 1  ; letter quality
  205.      EL 27 77     ; elite
  206.      CO \1B 0F    ; condensed
  207.      EX 27 87 1   ; expanded
  208.      PI 27 80     ; pica
  209.      DR 27 120 0  ; draft
  210.      BO 27 71     ; bold
  211.      IT 27 33 64  ; italics
  212.      S4 27 104 2  ; quadruple
  213.      S2 27 104 1  ; double
  214.      S1 27 104 0  ; normal
  215.      LF 10        ; linefeed
  216.      FF 12        ; formfeed
  217.      BL 27 10     ; backline
  218.      BF 27 12     ; backform
  219.      L8 27 48     ; 8 LPI
  220.      RE 27 64     ; reset
  221.  
  222.  
  223.      IMPORTANT
  224.      ~~~~~~~~~
  225.           Refer to  the "DESQVIEW INSTALLATION" section to see how a CDF
  226.      is loaded.
  227.  
  228.  
  229.  
  230.      MIXING PRINTER FEATURES
  231.      ~~~~~~~~~~~~~~~~~~~~~~~
  232.          Some printer features can't be combined.  Obviously, letter quality
  233.      and draft can't be.  Some other illegal combinations are not so obvious.
  234.      Some depend on printer design.  If your printer is capable of emulating
  235.      more than one kind of printer, it will have the same limitations as the
  236.      one it is emulating.
  237.  
  238.  
  239.      SUGGESTION
  240.      ~~~~~~~~~~
  241.          Printer manuals will show one control string to turn a feature ON
  242.      and another to turn it OFF.  Don't bother with commands to turn off
  243.      individual features.  Just use a "reset" command to clear out the prev-
  244.      ious setup.  Then, install another one.
  245.  
  246.  
  247.      BUILT-IN COMMANDS
  248.      ~~~~~~~~~~~~~~~~~
  249.          There are two of these.  They will work regardless of whether a
  250.      CDF is loaded.
  251.  
  252.              1.  #H will cause PS not to terminate itself when it has
  253.                  completed printing (hold mode).
  254.  
  255.              2.  #nn tells PS how many copies of a file to print.
  256.                  ( #6 = "print 6 copies" )
  257.  
  258.  
  259.      PRINTER BATCH FILES
  260.      ~~~~~~~~~~~~~~~~~~~
  261.          Phast Spool will print the files listed in a "printer batch file".
  262.      To enter the name of a batch file, preceed the filename with "@".
  263.  
  264.                   Example:
  265.                             @MYFILES.DAT
  266.  
  267.      This would cause all the files listed in MYFILES.DAT to be printed.
  268.  
  269.             MYFILES.DAT might contain something like the following.
  270.  
  271.                         /re
  272.                         stuff.txt el dr #2
  273.                         letter.dat re lq
  274.                         friday.log dr co #h
  275.                         /ff
  276.  
  277.      Batch files cannot be "nested".  In other words, you may not use "@"
  278.      in a batch file.
  279.  
  280.  
  281.  
  282.  
  283.                              MULTIPLE PRINTERS
  284.                              ~~~~~~~~~~~~~~~~~
  285.         If you have more than 1 printer connected to your computer, it is
  286.      a good idea to create a separate "Add a Program" entry for PS for
  287.      each printer.  Just name them something like "PRINTER1", "PRINTER2"
  288.      etc.  Then, you can dedicate a copy of PS to each printer.
  289.  
  290.                Parameters: C:\your_dir\your_cdf.cdf/2
  291.  
  292.         The "/2" would dedicate this entry to LPT2.  You could do the
  293.      same thing for LPT1 and LPT3.  This will insure that one copy of
  294.      PS running in one window will never interfere with printing being
  295.      done by another copy of PS in another window. This also facilitates
  296.      the use of separate CDF's for each printer.
  297.  
  298.  
  299.                                COMPATIBILITY
  300.                                ~~~~~~~~~~~~~
  301.         There is no hard, fast rule for control codes used with PC printers.
  302.      There is, however, a sort of quasi-standard adhered to by most manu-
  303.      facturers.  If you compare the included EPSON and IBM CDF's, you will
  304.      see that they are almost identical.  The control strings used in the
  305.      included CDF's were chosen by the author, in part, because they are
  306.      recognized by many printer models.  Chances are, one of these files will
  307.      work well with your printer.  If not, use your word processor to create
  308.      your own.
  309.  
  310.                                    End
  311.  
  312.  
  313.  
  314.  
  315.  
  316.      TRADEMARKS
  317.      ~~~~~~~~~~
  318.      DESQview(TM) is a trademark of Quarterdeck Office Systems.
  319.      IBM(R) is a registered trademark of International Business Machines Corp.
  320.      EPSON(R) and LQ1000(TM) are trademarks of Epson America Inc.
  321.  
  322.      DISCLAIMER
  323.      ~~~~~~~~~~
  324.      The author shall not be liable in any event for incidental or
  325.      consequential damages in connection with, or arising from, the
  326.      use of Phast Spool.
  327.      
  328.  
  329.  
  330.  
  331.      Licensing
  332.      ~~~~~~~~~
  333.  
  334.  
  335.      Phast Spool is a shareware program.  This means that you only pay for
  336.      it if you decide to continue using it.  If you don't think that it is
  337.      worth the asking price, delete the program.  If, however, you decide
  338.      to continue using it after a 2-week trial period, please send $15
  339.      along with the registration form to:
  340.  
  341.         Len Wilson
  342.         1342 Quivera Dr.
  343.         Denver, CO 80229
  344.  
  345.      The shareware fee pays for unlimited use of PS on a single computer.
  346.      You are encouraged to give away unregistered copies of PS with the
  347.      understanding that each person receiving a copy is under the same
  348.      obligation as you are to send in the shareware fee if they decide to
  349.      keep it.  You can upload PS (unregistered version) to other computer
  350.      systems as long as this archive remains intact.
  351.      
  352.  
  353.  
  354.  
  355.      REGISTRATION FORM
  356.      ~~~~~~~~~~~~~~~~~
  357.  
  358.  
  359.      TO:                      FROM:
  360.  
  361.      Len Wilson                  Name: ___________________________________
  362.      1342 Quivira Dr.
  363.      Denver, CO 80229         Company: ___________________________________
  364.  
  365.                                 Title: ___________________________________
  366.  
  367.                               Address: ___________________________________
  368.  
  369.                        City,State,ZIP: ___________________________________
  370.  
  371.  
  372.                             Telephone: ___________________________________
  373.  
  374.  
  375.  
  376.      Phast Spool Price Schedule
  377.      ~~~~~~~~~~~~~~~~~~~~~~~~~~
  378.      (One copy per computer)
  379.  
  380.      1-5   copies  - $15 each
  381.      5-20  copies  - $10 each
  382.      20+   copies  - One time fee of $200
  383.  
  384.  
  385.      I would like to register _______ copies of Phast Spool.
  386.  
  387.      I understand that I will receive the latest revision of Phast Spool
  388.      along with registration verification by mail within 2 weeks.
  389.  
  390.  
  391.  
  392.      Signature: _______________________________
  393.  
  394.  
  395.  
  396.                            DESQVIEW INSTALLATION
  397.                            ~~~~~~~~~~~~~~~~~~~~~
  398.      A .DVP file is included for your convenience.  Its use is optional.
  399.  
  400.      Shown below is the complete DV installation. Some options are more
  401.    important than others.  They are marked.
  402.  
  403.                ** Important options marked with an asterisk **
  404.  
  405.                               Add a Program
  406.  
  407.    Program Name............: ANYTHING
  408.  
  409.    Keys to Use on Open Menu: ANY KEYS               *Memory Size (in K):11
  410.    ------------------------------------------------------------------------
  411.    Program...: C:\your_dir\PS.EXE
  412.                                                  ***************************
  413.    Parameters: C:\your_dir\IBMPRO.CDF    <-------* Shows how to load a CDF *
  414.                                                  ***************************
  415.    Directory.: The directory you want as default.
  416.    ------------------------------------------------------------------------
  417.    Options:
  418.                      Writes text directly to screen.......: [N] *
  419.                      Displays graphics information........: [N] *
  420.                      Virtualize text/graphics (Y,N,T).....: [T] *
  421.                      Uses serial ports (Y,N,1,2)..........: [N]
  422.                      Requires floppy diskette.............: [N]
  423.  
  424.  
  425.                       Program Information Advanced Options
  426.  
  427.     System Memory (in K)......: 0  Maximum Program Memory Size (in K)..:
  428.  
  429.     Script  Buffer Size....: 1000  Maximum Expanded Memory Size (in K).:
  430.  
  431.     Text  Pages: 1  Graphics Pages: 0  Initial Mode:   Interrupts: 00 to FF
  432.     --------------------------------------------------------------------------
  433.      Window Position:
  434.     *Maximum Height:   18   *Starting Height:  18     *Starting Row...:   3
  435.     *Maximum Width.:   80   *Starting Width.:  40     *Starting Column:  20
  436.     --------------------------------------------------------------------------
  437.                                    Shared Program
  438.       Pathname..:
  439.                                       Data......:
  440.     --------------------------------------------------------------------------
  441.     *Close on exit (Y,N,blank)......: [Y] *Uses its own colors............: [Y]
  442.     *Allow Close Window command.....: [Y] *Runs in background (Y,N,blank).: [Y]
  443.      Uses math coprocessor..........: [N]  Keyboard conflict (0-F)........: [0]
  444.     *Share CPU when foreground....: [Y] *Share EGA when foreground/zoomed.: [Y]
  445.     *Can be swapped out (Y,N,blank).: [N]  Protection level (0-3).........: [0]
  446.  
  447.